Here's April! 

Subscribers who have been with us for 
some time will be happy to hear that we are 
shifting from copying our "yellow sheets" 
on our office copier to having them printed 
at a for real print shop. After several 
hundred thousand copies, our faithful copier 
is getting a break (mainly because it doesn't 
fold the sheets). Ah, success... 
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"Craps" is an interesting demonstration of how a computer flow chart 
operates. Each path in the algorithm is dynamically plotted as it is 
traversed. I have a friend who teaches a beginning programming class. 
He informs me that the old dice game of craps is the ideal program to use 
as an example problem to program. This version is sort of overkill on 
the subject, but it shows how the game works better than any explanation 
I ' ve ever seen. 

"Distance Scales" is good for beginning astronomers and space junkies 
of all types. It demonstrates that you can get there from here, but pack 
a big lunch and bring along some reading material, it's a long trip. 

"Hi-Que" is the old pegboard game where you move each peg by jumping 
over another peg. A perfect game is one that ends with one peg left, in 
the exact center of the board. 

"Typing" is a good one for those who want to learn touch typing. A 
computer is the ideal machine to learn typing on, for those of us so 
fortunate to have one. An observation I've made, however, is that few 
programmers of my acquaintance can type (or spell) . 

"Syzygy" is a worm game. In this case, the idea is to encircle your 
opponent with your worm. Each player is given five missiles (presumably 
because a worm has five hearts) . 

"Change" is a system tape that allows a programmer who has written a 



machine language subroutine on a level II 16K machine to make a level I 
4K system tape out of it (assuming that it doesn't need the level II ROM 
subroutines and is does not load higher than 4FFFH) . This one was 
originally written for in-house use, but turned out so nice that we just 
couldn't resist publishing it. There is a bit of explanation required 
for using it, however, so here goes: 

The level I machine does not have a "system" tape setup as such. 
Programs can be loaded into RAM and directly executed, but the level I 
BASIC ROMs have to be "tricked" into letting the program in RAM take 
over. The technique is generally known as "crashing the stack". Here's 
how the trick works: when you load a tape program in the level I machine, 
you do so with the CLOAD command (catchy name, eh?). The ROM calls its 
internal tape loading subroutine to load what it thinks is a BASIC 
program (which is all it has ever been told about) . Just before 
executing the tape load subroutine, however, it writes a return address 
down on the "stack" - an area of RAM memory set aside for short notes of 
this type. 

The level I tape data format starts out with a memory address. The 
tape loading subroutine puts the data which follows into memory starting 
at this address. This way, a program can be written that loads itself 
into any memory area of the level I machine. 

After loading the tape data, the tape loading subroutine goes back to 
the ROM program which CALLed it. It does this by the RETurn instruction, 
which gets the address to go back to from the stack. But wait! The 
stack is just another area in memory, and we can load data into any area 
of memory because the load address is on the tape. Aha! If we know 
where the level I's stack is (we do, it's at 41FEH and 41FFH) , we can 
make a tape that starts loading at that place. 

This is where it starts getting complex - we set up a tape to start 
loading at 41FEH. The first two bytes of "data" on the tape are 00H and 
42H. When loaded into the stack area (41FEH and 41FFH) , they form an 
address of 4200H. The data which follows is a machine language program 
which starts at 4200H. When the tape loading subroutine finishes loading 
what it thinks is a BASIC program, it RETurns to the ROM, or so it 
thinks. It wrote the address to go back to on the stack, and it assumes 
that the address is still there. It isn't - we changed it to 4200H. The 
tape loader isn't swift enough to realize that it's been fooled, so it 
RETurns to 4200H, passing control to the start of our program. 

So much for the trick of crashing the stack. Now let's talk a bit 
about the program "Change". The simplest way to use it is to write a 
machine language program designed to run on a level I machine, at an 
address of 4200H. Load the program "Change", then load your machine code 
program. "Change" will ask you to put a blank tape in the recorder, and 
then it will dump it at the level I rate (250 baud) , in level I format, 
with a stack crash pointer of 4200H. Suppose for some reason you don't 
wish to have your program run on the level I machine at 4200H. "Change" 
can handle this in two ways. Proceed as before, first loading "Change", 
then your machine language program. "Change" will sense that the load 
address is not 4200H, and will ask you to specify either null fills or a 
two program setup. The null fill option will create a tape that loads 
starting at the stack crash, continuing with OOH's (NOP command) from 
4200H to the start of your program, and then your program. This can be a 
drag to load for those programs stuffed into the higher part of RAM. The 
other option creates two programs, the first one being your machine 
language program, and the second one being a stack crash pointer (that 



is, a "program" consisting of the two bytes needed to pass control to 
wherever your program is at. This requires two CLOAD commands from the 
user of the level I machine. 

For those of you who are getting into the machine language swing of 
things, the ability to CALL subroutines in the level II ROMs is an 
obvious advantage. This allows a USER function written in machine 
language to take advantage of the compact, powerful subroutines that are 
already there. The only problem has been that documentation on what is 
available and how to use it has been essentially nonexistant. The book 
from Mumford Micro Systems (see ad in this issue) has been written to 
fill this need. It is 65 pages long and contains 18 chapters, covering 
the topics from internal representation of numbers and protocol of 
calling subroutines to specific examples of linking BASIC and machine 
language programs to form a composite. At the risk of sounding like I 
have an interest in the project (I don't), I can truthfully say that 
Everything You Always Wanted To Know About The Level II ROMs But Were 
Tired Of Asking Is Right Here, Folks. 
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See You Next Month 
Ralph McElroy, Publisher 




Has your TRS-80 been sluggish lately? Slow to respond? Had 
excessive keyboard bounce? 

The problem might be low voltage, or a BASIC misunderstanding, or 
IRON POOR SOFTWARE! 

Do you serve your TRS-80's meals on paper sheets? Do you 
(shudder) write it yourself? Recent studies indicate that keyboard- 
feeding causes MALIGNANT BUGS! 

CLOAD Magazine is published monthly on a magnetic IRON OXII 
tape, wound up inside a C-30 cassette. Now you may ask "Why 
bother?", but I can assure you that our computer cassettes are 
DIRECTLY readable, I repeat DIRECTLY readable by your 
computer. We have Thrills, Variety, and Absurdity. We have 
every program your computer has ever wanted to run after 
a hard day at the job We even include our infamous "yellow 
sheets" with every issue, filled with lies about the TRS-80 
computing scene. 

12 Monthly cassette issues S36.00 " 

(over 60 programs) 
Single issues S 3 50 * 

Best of CLOAD SIO OO ' 

(9 programs w/ listings) 

* CA residents please add 6% to non-subscription orders 
Please write for overseas rates 

Master Charge / Visa Welcome Also Cash & Gold 
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